<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
     qselect - select queues.

SYNTAX
     qselect [ -help ] [ -l resource=val,... ] [ -pe  pe_name,...
     ] [ -q wc_queue,... ] [ -s {r|p|s|z|hu|ho|hs|hj|ha|h}[+] ] [
     -U user,... ]

DESCRIPTION
     <I>qselect</I> prints  a  list  of  Sun  Grid  Engine  queue  names
     corresponding to selection criteria specified in the <I>qselect</I>
     arguments described below. The output of <I>qselect</I> can be  fed
     into  other Sun Grid Engine commands to apply actions on the
     selected queue sets. For example together with  the  -<I>mqattr</I>
     option  to  <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>,  <I>qselect</I>  can  be used to modify queue
     attributes on a set of queues.

OPTIONS
     -help
          Prints a listing of all options.

     -l resource[=value],...
          Defines the resources to be granted by the queues which
          should  be  included in the queue list output. Matching
          is performed on queues based  on  non-mutable  resource
          availability  information  only. That means load values
          are always ignored except  the  so-called  static  load
          values    (i.e.    "arch",   "num_proc",   "mem_total",
          "swap_total" and "virtual_total") ones. Also consumable
          utilization  is  ignored.   If  there  are  multiple -l
          resource requests they will be concatenated by a  logi-
          cal  AND:  a  queue  needs to offer all resources to be
          displayed.

     -pe pe_name,...
          Includes queues into the output which are  attached  to
          at  least  one of the parallel environments enlisted in
          the comma separated option argument.

     -q wc_queue,...
          Directly specifies the wildcard expression  queue  list
          to  be  included  in the output. This option usually is
          only meaningful in  conjunction  with  another  <I>qselect</I>
          option  to  extract a subset of queue names from a list
          given by -q.  Description of <I>wc</I>_<I>queue</I> can be  found  in
          <B><A HREF="../htmlman1/sge_types.html?pathrev=V62u5_TAG">sge_types(1)</A></B>.

     -qs {a|c|d|o|s|u|A|C|D|E|S}
          This option allows to filter  for  queue  instances  in
          certain states.

     -U user,...
          Includes the queues to which the specified  users  have
          access in the <I>qselect</I> output.

EXAMPLES
     =====================================================

     % qselect -l arch=linux
     % qselect -l arch=linux -U andreas,shannon
     % qconf -mattr queue h_vmem=1GB `qselect -l arch=linux`

     =====================================================

     The first example prints the names of those queues  residing
     on  Linux machines. The second command in addition restricts
     the output to those queues with access  permission  for  the
     users  <I>andreas</I>  and  <I>shannon</I>.  The third command changes the
     queue attribute <I>h</I>_<I>vmem</I> to 1 Gigabyte on queues  residing  on
     Linux  machines (see the <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B> manual page for details on
     the -<I>mattr</I> option  and  the  <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B>  manual  page  on
     details of queue configuration entries).

ENVIRONMENTAL VARIABLES
     SGE_ROOT       Specifies the location of the Sun Grid Engine
                    standard configuration files.

     SGE_CELL       If set, specifies the default Sun Grid Engine
                    cell.  To  address  a  Sun  Grid  Engine cell
                    <I>qselect</I> uses (in the order of precedence):

                         The name of the cell  specified  in  the
                         environment  variable SGE_CELL, if it is
                         set.

                         The  name  of  the  default  cell,  i.e.
                         default.


     SGE_DEBUG_LEVEL
                    If  set,  specifies  that  debug  information
                    should  be written to stderr. In addition the
                    level of detail in which debug information is
                    generated is defined.

     SGE_QMASTER_PORT
                    If set,  specifies  the  tcp  port  on  which
                    <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> is expected to listen for com-
                    munication requests.  Most installations will
                    use  a  services  map  entry  for the service
                    "sge_qmaster" instead to define that port.

FILES
     &lt;<I>sge</I>_<I>root</I>&gt;/&lt;<I>cell</I>&gt;/<I>common</I>/<I>act</I>_<I>qmaster</I>
                     Sun Grid Engine master host file

SEE ALSO
     <B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>, <B><A HREF="../htmlman1/qmod.html?pathrev=V62u5_TAG">qmod(1)</A></B>, <B><A HREF="../htmlman1/qstat.html?pathrev=V62u5_TAG">qstat(1)</A></B>, <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B>,

COPYRIGHT
     See <B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B> for a full statement of rights and  permis-
     sions.












































</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
